home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / comm2 / tramnt13.lha / Docs / TrAminet.doc
Text File  |  1995-08-17  |  6KB  |  157 lines
  1. Version
  2. =======
  3.  
  4. TrAminet v1.3 - thourth official version,
  5.                 well tested with AminetCD #5, #6 and #7.
  6.  
  7. What is it?
  8. ===========
  9.  
  10. TrAminet is a tool that processes Aminet CD 5, 6 and 7. The goal is to produce
  11. a filelist for online use with TransAmiga BBS. It checks the file TREE
  12. and INDEX on the CD's Aminet directory. Creates the directory stucture of
  13. tree on the hard disk and uploads the files listed in INDEX.
  14.  
  15. Disclaimer
  16. ==========
  17.  
  18. The program is well tested and I could not find a bug. As you know no
  19. program is really bugfree (hint: Murphy's law). It works perfectly on my
  20. system but I can't guarantee that it works on yours either. As usual you
  21. can't blame me for any damage that may be caused by the use or misuse of
  22. this program. It is provided as is. Use it at your own risk!
  23.  
  24. Distribution
  25. ============
  26.  
  27. The use of the program is free of charge but the copyright still is mine.
  28. Everyone who has use for this program may use it. I only ask for keeping
  29. the archive complete. Don't delete any files or ADD any! I hate those
  30. ZZEndPad and similar files that are added by a wide range of BBS's. I don't
  31. want such files in my archives and you will not find them on my BBS. The
  32. archive may be distributed via Aminet and BBS's but not via any PD series
  33. without my written agreement. You are not allowed to ask for a charge if
  34. you give the archive to someone else. If you give it away on disk then ask
  35. for a Disk in return or a fee that is not higher than a new disk of the
  36. same type.
  37.  
  38. Requirements
  39. ============
  40.  
  41. You need the AmigaDOS JOIN command. If you did not delete it it should be
  42. located in your c: directory. Also the standard RAM: is needed. If you
  43. don't want to use RAM for that just make a RAM: assignment to a directory
  44. on your hard drive. This is only necessary if you changed the C= default
  45. installation to avoid having RAM:.
  46.  
  47. AmigaOS 3.1 Assign command or a PD command that supports TRUE multiassign
  48. is needed.
  49.  
  50. Commandline
  51. ===========
  52.  
  53. TrAminet Path/A NODESC/S
  54.  
  55. On my system path is the multiassign Aminet:
  56.  
  57. Description
  58. ===========
  59.  
  60. The only parameter needed is a multiassign. Multiassigns are a bit tricky
  61. but actually it's the only way to use CD-ROMs with TransAmiga BBS (if they
  62. don't have a Files.BBS in every directory that is in TransAmiga format).
  63. Sure it is possible to write a door that accesses the CD-ROM directly and
  64. handles downloads, but I think the multi-assign method has more advantages
  65. as you can use TransAmiga's normal routines.
  66.  
  67. How can this multiassign be done? It's easy and you don't have to know how
  68. it really works. AmigaDOS provides the possebility of multiassigns. It is
  69. possible that it works differently on different AmigaOS versions! If the
  70. multiassign does not work on your Amiga the way I expect it get a program
  71. like 'true multiassign' that adds real multiassigns to your Amiga. Ok, here
  72. is how it works on my system:
  73.  
  74. In my user-startup I have the following assignments:
  75.  
  76. Assign Aminet: file:CDROM/Aminet
  77. Assign Aminet: CD0:Aminet ADD
  78.  
  79. The second line ADDs an assignment to the allready defined assignment.
  80. That's a multiassign - one assign leads to more than one directory. How
  81. does it work? It's simple. AmigaDOS searches the first directory for the
  82. file you want to open or examine. If it can't find it the next directory in
  83. the multiassign list is processed. ATTENTION! The first path HAS NOT to be
  84. the CD-ROM! My program makes directories and files in the first directory
  85. of the assignment list!
  86.  
  87. Note: AmigaDOS commands DIR and LIST do not know multi-assigns so if you
  88. use them to list Aminet: (in my example) you will get the content of the
  89. first path of the multi-assign list. In this case it's the directory on the
  90. hard drive.
  91.  
  92. NODESC is a switch and an optional parameter. If you specify it the .readme
  93. files on the CD will be ignored and not appended to the .Desc files. This
  94. save HD space and program execution time.
  95.  
  96. Let me write some words about speed. It takes a long time to process all
  97. files so be sure you don't need the shell you start TrAminet in. I don't
  98. suggest to use the RUN command as the output to CLI is still there. You can
  99. send it to NIL: then there is no argument against run, but you won't get
  100. any failtrue messages... Speaking of error messages... There may come up
  101. several messages that tell you that JOIN was aborted due to an error. Don't
  102. panic, that's ok. The program makes .Desc files (if you did not specify NODESC
  103. commandline parameter) out of the .readme files on the CD so the BBS user can
  104. read a long description if he wants to. To produce .Desc files in TransAmiga
  105. formant I have to join two files so I used the join command as it's faster
  106. than reading the .readme file and appending it to the .Desc file line by
  107. line... The time needed to process the CD mainly depends on the speed your
  108. CD-ROM drive has. The faster it is the faster the program will finish.
  109.  
  110. The program produces a fragment for your file.cfg in RAM: It is called
  111. File.cfg (what else ?-). The number of found fileareas is displayed in the
  112. Shell. (It's 180 for Aminet CD 6/95). Add the number to the number of
  113. fileareas in your file.cfg and insert the file.cfg fragment in your own
  114. File.cfg where you wish the areas to appear. I suggest at the end, just
  115. before the packer definition.
  116.  
  117. Now you're ready to access the CD from your TransAmiga BBS.
  118.  
  119. This program was written for AminetCD #5 and #6 but may work with future
  120. releases if they don't change the format. If there is need to update
  121. this program I'll do it.
  122.  
  123. I hope I did not forget to mention something...
  124.  
  125. If you have any questions write me a mail.
  126.  
  127. Example
  128. =======
  129.  
  130. If the mentioned assign is done you can run TrAminet like follows:
  131.  
  132. TrAminet Aminet:
  133.  
  134. or
  135.  
  136. TrAminet Aminet: nodesc
  137.  
  138. The last one prevents TrAminet from joining the .readme files to the .Desc
  139. files. You loose the information contained in the readme files, but most
  140. users do not check the long description of files so there is nothing lost
  141. for those user group.
  142.  
  143. Contact
  144. =======
  145.  
  146. You can contact me via fidonet, email, fax and postal mail:
  147.  
  148. Fido: 2:2476/12
  149. email: rasa0011@fh-karlsruhe.de
  150. fax: +49-[0]721-859433
  151. postal mail:
  152.  
  153. Sami Radwan
  154. Uhlandstr. 10
  155. D-76135 Karlsruhe
  156. Germany
  157.